Skip to content

feat(website): changelog change markers, smooth scrolling, sticky banner, header blur and /docs for the current docs - #25

Merged
diecodev merged 6 commits into
fix/changelog-client-renderfrom
feat/website-polish
Oct 30, 2026
Merged

diecodev merged 6 commits into
fix/changelog-client-renderfrom
feat/website-polish

Conversation

@diecodev

@diecodev diecodev commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

Stacked on #24: merge that one first.

Changes

  • Header blur in Chromium. Lightning CSS, Vite 8's CSS minifier (build!: require Qwik 2.0.0-rc.4 and move to Vite 8 #23), kept only the -webkit-backdrop-filter, which Chromium ignores. The CSS now writes the standard property alone, and Lightning CSS adds the prefix Safari needs.
  • Changelog: a symbol per kind of change, in qwik-date's style. Each section of a release is marked with data-kind, read from its heading. This works with both the curated notes and changelogithub's.
    • Each change gets a symbol in place of its bullet: ! breaking (amber), + new (blue), ~ fix and − deprecated (gray).
    • The headings stay neutral, and a legend under the filters uses the same symbols.
  • Smooth scrolling to sections of the same page (the table of contents, heading anchors, /page/#section).
    • A sync$ click handler sets scroll-behavior only for those links. The router scrolls page changes with the same calls, so a global rule would animate those too.
    • Page changes still jump to the top, and prefers-reduced-motion keeps the jump.
  • Banners. The current docs no longer show "v2 is in beta"; the header badge and the install section already say it.
    • The banner on the docs of an older line sticks with the header, on one line at any width (a shorter text below 1000px).
    • The sticky sidebar, table of contents, mobile menu and heading anchors all start below the header and banner, through --docs-top.
  • /docs serves the current docs. The v2 pages move from /docs/v2/… to /docs/…, and an older line keeps /docs/v<n>/… (/docs/v1/…).
    • vercel.json redirects /docs/v2/… to /docs/… (308), so existing links keep working.
    • The paths come from CURRENT_VERSION. website/README.md explains what to move when a new major ships.

Checks

  • fmt.check and lint pass at the root. build.types, lint and the full SSG build pass in website/.
  • The build prerenders 13 pages, and the sitemap has /docs/, its 7 subpages, /docs/v1/… and the changelog.
  • On the built site, in chromium and webkit:
    • <Link> navigation to every page, plus the changelog filter, works with no console errors (2 rounds).
    • The version menu switches between /docs/toast/ and /docs/v1/api/, with the active sidebar link, pager and edit link right on both.
  • Smooth scrolling, measured on scrollY: a TOC click animates, a page change jumps to 0, and with prefers-reduced-motion it jumps.
  • Banner: its bottom edge sits at 98px at every width from 320 to 1280px. It stays under the header while scrolling, and doesn't show on the current docs or the changelog.
  • Header: the computed backdrop-filter is back in Chromium, and the built rule has both the prefixed and the standard property.
  • No horizontal overflow at 390px on any page.

The /docs/v2/… redirects only exist in vercel.json, so this PR's Vercel preview is where to try them. On pnpm dev those addresses return 404.

Lightning CSS, Vite 8's CSS minifier, kept only the -webkit-backdrop-filter of the header (written after the unprefixed one), which Chromium ignores. Write the standard property alone and let it add the prefix Safari needs.
Each section of a release (breaking changes, features, fixes, deprecations) gets its color, from its heading, both in the curated notes and in the ones changelogithub writes: the heading, a rule along its list and the bullets. A legend under the filters names the colors.
Links to a section of the page you're on (the table of contents, heading anchors, /page/#section) scroll smoothly; page changes still start at the top at once, and prefers-reduced-motion keeps the jump. A sync$ click handler sets scroll-behavior only for those links, since the router scrolls page changes with the same calls.
…ne under the header

The current docs no longer show the "v2 is in beta" banner: the header's badge and the install instructions already say it. The banner on the docs of an older line now sticks with the header, on one line at any width (a shorter text on narrow screens), and the sticky sidebar, table of contents, mobile menu and heading anchors start below both (--docs-top).
The current line's docs move from /docs/v2/… to /docs/…, and an older line keeps /docs/v<n>/… (/docs/v1/…). vercel.json redirects /docs/v2/… to /docs/… for the links already out there. The paths come from CURRENT_VERSION (versions.ts), and website/README.md says what to move when a new major ships.
@vercel

vercel Bot commented Oct 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
qwik-sonner Ready Ready Preview Oct 30, 2026 4:18am UTC

@diecodev
diecodev added this pull request to stack #26 October 30, 2026 04:11
Instead of colored headings, rules and bullets, each change gets a symbol in place of its bullet, as in qwik-date: ! breaking (amber), + new (blue), ~ fix and − deprecated (gray). The headings stay neutral and the legend uses the same symbols.
@diecodev diecodev changed the title feat(website): changelog colors, smooth scrolling, sticky banner, header blur and /docs for the current docs feat(website): changelog change markers, smooth scrolling, sticky banner, header blur and /docs for the current docs Oct 30, 2026
@diecodev
diecodev merged commit d037208 into v2 Oct 30, 2026
5 checks passed
@diecodev
diecodev deleted the feat/website-polish branch October 30, 2026 04:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant